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access to a particular pipe, it is assumed that the user is authorized and authenticated through all of 
the operations of a pipe. 

A selector is passed the name of the desired functional module and the name of the organization. 
The module name is also the name of the XML document containing the structure of the page to 
be rendered. 

The XML document follows the structure of the page, like so: 

<xml> 
<module> 

( This section describes the name, organization, & logo information for this module) 
<section> 

(This section describes any menus or button bars that appear in the page header) 
</section> 

<sub_section> 

(This section describes any button bars, drop down list selectors, combo box selectors, 
data entry fields) 

</sub_section> 

<content> 

(This section describes any user interface components required for the content portion of 
the page. This can include ail of the user interface elements described previously, plus 
any applets, flash movies or other multimedia elements as required) 
</content> 

<toolbar> 

(This section describes any selectors, checkboxes, button bars, drop down list selectors, 
combo box selectors, or data entry fields required.) 

</toolbar> 
</module> 

Where possible, we have tried to use pre-existing standards for interface definition, rather than 
making up our own. Consequently, please refer to the following two documents located at the 
following URLs to get a flavor of the philosophy behind this structure: 

XUL Tutorial http://vww.xulplanet.com/tutoriats/xuitu/ 

XUL Programmer's Reference Manual http://www.moziiia.org/xpfe/xuiref/ 

An example of this XML file structure, describing the NetCensus General Traffic Statistics page 
shown on page one of this specification is included on the next page. Although this description 
only describes the module, section, sub-section, and toolbar portions of the page, it should be 
enough to provide a flavor of how to define a page for use in the Marketing Framework. This file 
would be generated by an XSP script running in response to a user requesting a specific URI from 
a Cocoon server. 



Company Confidential - Centerville Technologies, inc. 



-26- 



XML Specification for Defining Marketing Framework Components 
April 11, 2001 - Draft, v0.5 



<?xml vers£on="l 0" encodmg="UTF-8 ">> 

<t- ed.ted with XW U Spv vj 5 NT fhUp ,.w\'a\ xmKpv ccmi by N W Kaufman (CenJer^tlle Technologies/Engineering, 
<moduie name="NetCensus* son!fied="yes''> 
<section> 

<menu name="main" prompt="S ELECT A SECTION "> 

<menuitem name= "General Site Traffic" value="http://think. with-us.com/nc/trafficV> 
<menuitern name= a Database Statistics" va)ue^"lttp://think.with-us.conVnc/statistics7> 
<menuilem nam e=" Marketing Performance" vaiue="http^/think.vvitrhus.corn/nc/performaw 
<menuitem name= "Commercial Investment" value- "rrttp://think. with ^ 
<menuitem name=Turchase Pathway* va}ue="http://lhink.with-iKxom/r«^pathwayV> 

</menu> 
</section> 

<sub_section name=*Generat Site Traffic*^ 

<seiector name='site_name" method=*post" action="> 
<list name="SITES" prompt="SELECT A SITE"> 

<listttem name="SALES SITES" value="107> 

<listitem name="- Main Portal" value="1 17> 

<listitem name="- Portal US" valuer" 127> 

<listitem name="- Portal Europe" va!ue="137> 

<tistitem name="- Portal Asia" value="147> 

<tistrtem name="- Business* vafue="157> 

<listitem name="- Leisure* value= B 167> 

<listitem name= H - MCC" valuer "177> 

<listrtem name="- Cafe Express" value="t87> 

<listitem name="HOTEL SiTES" vatue="207> 

<listitem name="- Aberdeen" value="21 "/> 

•clistrtem name="- Birmingham'' value='227> 

<list«tem narne="- Kent" vatue="23"/> 

<!istitem name="- London" value="247> 
</hst> 

<date_picker name^FROM" cfass="date" action="select7> 
<date_picker name=" UNTIL" ctass="date" actions-select"^ 
<button name="go" prompt-"go" action="submir/> 
</selector> 
</sub_section> 
<content> 

<panel width= u 64%"> 
<tine> 

<checkbox label='Page Views :" va!ue="18437> 

<checkboxlabel="Home Page views :* value= M 18437> 
</line> 
<iine> 

<checkbox tabel="N umber of Visitors :" value="18437> 

<checkbox !abei="No. of Visitors per day :" valued 1 8437> 
</line> 
<ltne> 

<checkbox label="New Visitors :* value="18437> 

<checkbox label=" Length of Time on site va!ue="18437> 
</}ine> 
<line> 

<checkbox label="Repeat Visitors vaiue="18437> 
<checkbox label=' Average no. of pages visited :" value="18437> 
</line> 

<tabie titles" Most Popular Pages* type="numbered"> 

<checkbox labe!= Millennium Deals" value="18437> 

<checkbox fabeW'Stay.with-us - Hotel View" value="18437> 

<checkbox label=°Make a Booking" value="18437> 

<checkbox labe!=° Picture Gallery" vaiue="18437> 
</tabie> 

<table tjtte=Top Referring Sites" type-"numbered"> 

<checkbox !abe l= " LondonTown .com" value="18437> 

<checkbox label-'Thomas Cook" value="t8437> 

<checkbox label-" Sony.com" value="18437> 
</table> 
</panel> 

<panel width = "36%" >This is panel two (graph goes here) 
</panel> 
</content> 
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<too!bar name-'exportBar" prornpl="export to »"> 

<tool name="excel Export' label^'EXCEL* action= K doExc el Export* tip= M Export this data to an MS Excel file7> 
<tool name="pPointExport" label="POWER POINT" actk>n='doPPotrtt£xport" tip=" Export this data as a PowerPoint 

presentation 7> 

<tool name="wordExporr labei='WORD" action="doWord Export" tip=*Export this data to an MS Word file7> 
<tool name="jpegExporT tabe*="JPEG* actk>n="doJPegExporf tip="Export this data as a JPEG image'/> 
<button name^printGraph* fabei= u PR!NT actior^'doPrintGraph* tip=*Print a copy of the graph7> 
</tootbar> 
</modiile> 



Section & Tag Descriptions 



<module name=" text.display" sonified-" yes.or.no "> 

The <moduie> section of the tile is used to hold any information about the pipeline that may be re- 
quired throughout the life of the document as it moves through the pipeline. This tag takes a sin- 
gle attribute, which is the name of the module to display. The sonification attribute is used to in- 
voke the built-in Beatnik sounds for buttons, checkboxes, and tool bars. To date, we have defined 
the following tags: 

<organization> 



Specifies the name of this company (and it's associated stylesheet). 



<logo location^" text.uri or file name "/> 



Specifies where the company's logo can be found, in either gif, jpeg, or png format. 



<section> 

The <section> portion of the file is used to hold any information about the content that needs to ap- 
pear at the immediate top of the page. Typically, this will include one or more menus or button 
bars, from which the user will make a section that will cause other portions of the page to load. 
To date, we have defined the following tags: 

<menu name=" text" prompts" text.display"> 

Indicates that a menu should appear in the first available position in the section. This tag 
and its associated sub-tags describe the format of the menu to be displayed. (Typically 
these will appear as DHTML drop-down menus.) The structure of this tag is loosely based 
on the XUL standard for describing menu objects, although it is a subset of the 
specification, since many of the attributes do not make sense in the context of our 
application. 

name Name of menu object (for use with DHTML) 
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prompt Prompt text that appears in the user interface followed by a 
down arrow indicating where the user should click. 



<menuitem name=" text.display" vaiue=" uri.destination "> 

Indicates that an item should appear in the parent menu. This tag and its associated 
properties describe the format of the item to be displayed in the menu. 

name Contains text to be displayed for this item in the drop 
down menu. 

value URl of the web page to display if the user selects this 
menu item. 



<sub_section name=" text.display "> 

The <sub_section> portion of the file is used to hold any information about the content that needs 
to appear in the zone at the lower part of the top of the page. Typically, this will include one or 
more menus or button bars, or various "selector" interface widgets to allow the user to be able to 
search a database or otherwise modify what is displayed in the content section of the page. This 
tag takes a single property, the name of the sub-section, which is formatted and displayed as a title 
in the sub-section area of the page. To date, we have defined the following tags: 

<selector name=" text " method=" text.method " action=" javaScriptfunction "> 

Indicates that a form is to be inserted here to allow a user to make choices that will adjust 
the contents of another section of the application. The selector tag marks the demarcation 
points for the form, and any widgets that will have their values submitted to the server 
when the user clicks on the submit button. 

name Name of the form object, which is required in order to 

manipulate the form via JavaScript / DHTML 

method Text that indicates the method for handling the HTML form 
data. 



action Can be used to invoke a JavaScript / DHTML routine when 

the user submits this form. 

<button name=" text " prompt=" text.display" action=" text "> 

Indicates that a button widget with a text label should be displayed in the first avail- 
able position with in the selector to allow a user to perform some action to the 
selector. 
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name Name of button object {required so list box contents can 
be accessed via JavaScript / DHTML). 

prompt Text that displays as a prompt on the face of the button, 
action Text that is filled in as the HTML button type. 

<date_picker name=" text" prompt^" text.display"> 

Indicates that a single date widget should be displayed in the first available position 
with in the selector. A date widget allows the user to be able to specify a date in 
the form of MM/DD/YYYY, where "MM" is equal to the two digit value for the 
month of the year, while "DD" is equal to the two digit value for the day of the 
month, while "YYYY" is equal to the four digit value for the century. 

name Name of datejptcker object (required so iist box contents 
can be accessed via JavaScript / DHTML). The individual 
fields in the widget will be accessible as name.mm for the 
month name.dd for the day, and name.yyyy for the year. 

prompt Text that displays as a prompt directly to the left of the list 
box widget. 



<list name=" text " prompts" text.display"> 

Indicates that either a single list box widget should be displayed in the first avail- 
able position with in the sub-section to allow a user to put together a query to mod- 
ify the specific contents of the content section of the page. 

name Name of list object (required so fist box contents can be 
accessed via JavaScript / DHTML). 

prompt Text that displays as a prompt directly to the left of the list 
box widget. 



<listitem name=" text.dispfay " value=" text.value"> 

Indicates that an item should appear in the list box widget. This tag and its 
associated properties describe the format of the item to be displayed in the 
menu. 

name Contains text to be displayed for this item in the list 
box widget 

value Text with value information (either alpha or 

numeric) that will be passed via a form submit. 
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<content> 

The <content> portion of the file is used to hold any information about the content that needs to ap- 
pear in the zone directly in the middle of the page. This can be defined in a variety of ways to re- 
flect a number of different display formats. This section can either be rendered as a single entity, 
or broken down into a series of vertical "panels. Within a panel, additional content can be speci- 
fied using either <line> or <table> tags (more information on this is available on the following 
pages). A good way to think about this structure is to consider it as being very similar to HTML 
tables where panels are equivalent to columns, and windows are equivalent to rows. However, 
this metaphor is not completely accurate, as we encapsulate the row data within a column, where 
in an HTML table the column data is encapsulated within the row data. This was changed for two 
reasons: the first was for easier processing within the XSLT engine; while the second had to do 
with how we were expecting data to be handled within the system. 

<graph> 

Indicates that the content contained within this tag should be rendered as a graph using the 
XSLT SVG graphing stylesheet. 

<panel width=" number.percentage " > 

Indicates that a vertical panel should be created in the content section of the page. Panels 
act as a way to organize content that should be located together on the page. 

Number used as a percentage of the width of the browser win- 
dow. Using a percentage allows us to rescale the relationship 
between individual objects within the page. Please note that 
the total width of all panels must not exceed 100%, as there is 
no error checking within the XSLT style sheet.. 

<line> 

Indicates that the content contained within this tag should be rendered as being on a single 
line, either inside of a panel, or simply within the entire content section of the page. Small 
lines of text, and selectors can be specified inside of <line> tags, and these will be rendered 
as a single line of content - similar in function and look and feel to a toolbar. Within a 
set of <line> tags, it is possible to specify the following tags: 

<chart„picker name=" text" prompts" text.disptay "target= 

u chart.name"> 

Indicates that a single chart type selection widget should be displayed in the first 
available position with in the line. A chart type selection widget allows the user to 
be able to specify the plot format of the chart named in the target property for the 
tag. 

name Name of chart_picker object. 
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prompt Text that displays as a prompt directly to the left of the 
chart picker selection widget. 

target Name of the chart that this picker is associated with. 



<data prompt=" text.display" type=" datatype w class=" class.type "> 

Indicates that a single piece of data should be displayed in the first available 
position with in the line. The format of the data is specified using both the type and 
class attributes as described below: 

Text to display to the left of the data as an explanatory 
label. 

Can be one of three values: NUMBER, TEXT, or 
PERCENT. Specifying TEXT forces the prompt and the 
data to have the same amount of display space. 
Specifying either NUMBER or PERCENT causes the data 
to be displayed with the prompt taking up about 80% of 
the space, and the DATA taking up about 20% of the 
display space. 

Can be specified as either MAJOR or MINOR. MAJOR 
data is rendered in bold and in a slightly larger type than 
MINOR data elements. 

<text> 

Used to render small amounts of text within the context of a set of <line> tags, or can be 
used by itself to render text either in a <panel> or simply stand-alone in the content sec- 
tion. 

<table title=" text.display" type=" type.table"> 

Indicates that the content contained within this tag should be rendered in the form of a 
table* either inside of a panel, or simply within the entire content section of the page. Tab- 
les currently come in only two types - numbered and unnumbered. A numbered table gen- 
erates a list of entries with a number in front of each one, while an unnumbered table gen- 
erates them as a bulleted list. 

title Text to display as the title of the table. This text is handled 

differently depending on the XSLT and CSS style sheets used 
to create the final HTML document. 

type Determines how content is formatted within the table. 

Currently this attribute only supports two values: numbered, 
which creates a numbered list of items; and unnumbered 
which creates a bulleted list. 



prompt 
type 

class 
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<tooibar name=" text" prompts" text.prornpt"> 

The <toolbar> portion of the file is used to hold any information about the toolbar that runs along 
the bottom of the page. This can be defined in two ways - there are a series of selections (a.hcL 
"tools'* ) that can be made from the solid colored section in the middle of the bar, and typically 
these selections will all be related to each other and would directly affect the content in the content 
pane. Because of this, typically the targets of the individual toolbar elements will probably be re- 
ferences to JavaScript / DHTML routines embedded in the page. On the right section of the tool- 
bar are a series of buttons that can be used to start external events, such as sending a copy of the 
web page to a printer. 

The components in the toolbar are always rendered as text links without decoration that can be 
clicked on to initiate an action. 

name Name of toolbar object (for use with DHTML) 

prom pt Prompt text that appears in the toolbar to the left of the 

selections. 

<button name=" text " label=" text.disp!ay" action=" text " tip=" text"> 

Indicates that a link with a text label should be displayed in the first available position on 
the right side of the toolbar to allow a user to perform some action that affects the page as a 
whole. 

name Name of button object {required so list box contents can 

be accessed via JavaScript / DHTML). 

label "Text that displays as a prompt on the face of the toolbar. 

Text that is used as the destination for an associated 
HREF tag. 

Text that appears as a "tool tip" when the user leaves 
the cursor over the link for more than a couple of 
seconds. 



action 
tip 



<tooi name=" text " labels" text.display " actions" text " tip=" text "> 

Indicates that a link with a text label should be displayed in the first available position with 
in the middle of the toolbar to allow a user to perform some action related to the content in 
the content section. 

name Name of button object (required so list box contents can 

be accessed via JavaScript / DHTML). 

label Text that displays as a prompt on the face of the toolbar. 

action Text tnat & used as tne destination for an associated 

HREF tag. 
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tjp Text that appears as a "tool tip* when the user leaves 

the cursor over the link for more than a couple of 
seconds. 
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